GETUSERSHELL

Section: C Library Functions (3)
Index Return to Main Contents

BSD mandoc
BSD 4.3

NAME

getusershell setusershell endusershell - get legal user shells

SYNOPSIS

Ft char * Fn getusershell void Ft void Fn setusershell void Ft void Fn endusershell void

DESCRIPTION

The Fn getusershell function returns a pointer to a legal user shell as defined by the system manager in the file /etc/shells If /etc/shells is unreadable or does not exist, Fn getusershell behaves as if /bin/sh and /bin/csh were listed in the file.

The Fn getusershell function reads the next line (opening the file if necessary); Fn setusershell rewinds the file; Fn endusershell closes it.

FILES

/etc/shells

DIAGNOSTICS

The routine Fn getusershell returns a null pointer (0) on EOF

HISTORY

The Fn getusershell function appeared in BSD 4.3

BUGS

The Fn getusershell function leaves its result in an internal static object and returns a pointer to that object. Subsequent calls to Fn getusershell will modify the same object.

This document was created by man2html, using the manual pages.
Time: 16:28:58 GMT, April 18, 2022